home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 30 / autosn21.zip / AUTOSCAN.DOC next >
Text File  |  1991-01-29  |  7KB  |  169 lines
  1.        
  2.  
  3.                               AUTOSCAN V2.1
  4.                               ~~~~~~~~~~~~~
  5.  WHY
  6.  ~~~
  7.  I needed a quick and easy way of checking my Recent Upload Files Area
  8.  for viruses on my BBS. I wasn't happy with the "shells" that were 
  9.  available so I decided to write my own...AUTOSCAN...
  10.  
  11.  AUTOSCAN was written to work with the McAffee SCAN program. 
  12.  (SCAN.EXE is Copyrighted by the McAfee Associates, Please register this
  13.   fine product if you haven't yet!).
  14.  
  15.  HOW
  16.  ~~~ 
  17.  The way it works is real simple, all it does is un-archive any ZIP,ARC
  18.  ICE,LZH or PAK files into a work directory, then uses SCAN.EXE to 
  19.  to scan it. If all goes well and no viruses are found it deletes all 
  20.  the "work" files and then moves onto the next file and repeats the 
  21.  process.
  22.  
  23.  To get going is real simple, copy AUTOSCAN.EXE into a directory off
  24.  the path statement (Like the DOS directory) and then change to the
  25.  directory you wish to scan. All you have to do is type AUTOSCAN. 
  26.  AUTOSCAN will then look through the Current Directory for ZIP, ARC, 
  27.  ICE , PAK, and LZH files, un-archive them and scan them, if all goes
  28.  well it will proceed onto the next file. In order for everything to
  29.  work all the un-archivers should be within reach upon the currect path,
  30.  PKUNPAK.EXE, PKUNZIP.EXE, ICE.EXE, PAK.EXE and most important SCAN.EXE
  31.  If any of the un-archivers are not found that section will not exectute,
  32.  you don't need them all to run AUTOSCAN, however if SCAN.EXE is not
  33.  located the program will halt.
  34.  
  35.  Note: If PKUNPAK.EXE or LHARC.EXE isn't found AUTOSCAN will look for
  36.        PKXARC and ICE respectivly.
  37.  
  38.  AUTOSCAN will keep a detailed log of it's activities in the same
  39.  directory that contains AUTOSCAN.EXE, it will be named AUTOSCAN.LOG, if it
  40.  already exists new information will be appended to it.
  41.  
  42.  WHAT IF
  43.  ~~~~ ~~
  44.  Ok you say, what if there is an archive within an archive ?..NO PROB!
  45.  AUTOSCAN will detect if there are any archives within archives - to any
  46.  level and any combination of archive types, if an error is located in a
  47.  "sub archive" that name is placed in the log along with the "parant archive"
  48.  name and what the error was, Virus or bad archive.
  49.  
  50.  COMMAND LINE OPTIONS
  51.  ~~~~~~~ ~~~~ ~~~~~~~
  52.  /S
  53.  If you wish to have your Hardrive scanned as well put a /S at the
  54.  on the command line:  AUTOSCAN /S.
  55.  Drives C: through H: will be scanned if they exist. Only EXE,COM and OVL
  56.  files will be checked.
  57.  
  58.  /Q 
  59.  When AUTOSCAN finishes it sounds a two tone bell a few times, or in the
  60.  case of a VIRUS, many times! If you wish to run it in the QUIET MODE put
  61.  a /Q on the command line:  AUTOSCAN /Q. 
  62.  this will shut it up..
  63.  
  64.  /C 
  65.  See check.doc on this one.
  66.  
  67.  /N  * - Registered Version.
  68.  This will instruct AUTOSCAN to check for Bad Archives ONLY, only use this
  69.  option if you are sure the file is free of Virus's. 
  70.  
  71.  /A  * - Registered Version.
  72.  This will instruct AUTOSCAN to examine ALL archives on ALL drives, the
  73.  granddaddy option!.. Only use this if you have all day to let it run..
  74.  This option will be available soon.
  75.  
  76.  Any of the above option can be used in any order and any combination.
  77.  
  78.  HELP and SCAN.EXE
  79.  ~~~~ ~~~ ~~~~~~~~
  80.  For help on the fly type AUTOSCAN ? and it will display some information
  81.  about itself.
  82.  
  83.  In order for AUTOSCAN to detect all known Virus's you must keep your
  84.  version of SCAN.EXE as current as possible, AUTOSCAN is only as good
  85.  as the Scanner it uses. SCAN.EXE can be found on most good Bulletin 
  86.  Boards in your area. 
  87.  
  88.  *.BAD
  89.  ~~~~~
  90.  If AUTOSCAN comes across a bad Archive or a Virus that file will be
  91.  renamed to "filename".BAD and make a note in the log indicating which
  92.  file is SUSPECT of being bad. If a file is flagged as being bad you 
  93.  might want to examine it manually to see why.
  94.  
  95.  F10 - ABORT 
  96.  ~~~ ~ ~~~~~
  97.  While AUTOSCAN is running the pressing of F10 will cause AUTOSCAN to
  98.  abort the current session. AUTOSCAN will only stop once the current file
  99.  has been finished and the work files all deleted. Please be patient!.
  100.  AUTOSCAN will report on the current status of it's operation and 
  101.  further runnings of AUTOSCAN will just pick up where it left off.
  102.  AUTOSCAN will exit on an ERRORLEVEL of 0 in this case.
  103.  
  104.  AUTOSCAN.DAT
  105.  ~~~~~~~~~~~~
  106.  Once AUTOSCAN has completed its operations it will update a file called
  107.  AUTOSCAN.DAT, this file contains a list of files that have already been
  108.  scanned. This makes it possible to run AUTOSCAN after each user has 
  109.  logged off my board, if any new files were uploaded they get scanned right
  110.  away and removed from circulation if needed. 
  111.  
  112.  THE NAUGHTY BITS
  113.  ~~~~~~~~~~~~~~~~
  114.  Each time AUTOSCAN starts up it checks it's own size, if it has changed 
  115.  any AUTOSCAN will terminated with a nasty message..AUTOSCAN will also
  116.  check disk space each time it starts up, if the amount of disk space left
  117.  is less than 150% of the archive size AUTOSCAN will exit on a ErrorLevel 1.
  118.  
  119.  ERRORLEVELS
  120.  ~~~~~~~~~~~
  121.  AUTOSCAN will exit on one of 5 DOS ErrorLevels..
  122.  
  123.            ErrorLevel 0 - New Files found and processed.
  124.            ErrorLevel 1 - SCAN.EXE missing / No Disk Space /
  125.                           AUTOSCAN.EXE infected / File Error.
  126.            Errorlevel 2 - No New Files. 
  127.            ErrorLevel 3 - Bad Archive, Renamed to .BAD.
  128.            ErrorLevel 4 - VIRUS, Renamed to .BAD.
  129.  
  130.  WHAT IN
  131.  ~~~~ ~~
  132.  AUTOSCAN is written in Turbo Pascal 6.0 and some routines are from
  133.  the TechnoJock Turbo Toolkit V5.0 (excellent package if your a TP 4/5/6
  134.  programmer)... Oh yea, and AUTOSCAN was written by me Nick Tucker.
  135.  I can be reached at \/elocity - 908-781-1776, FidoNet 1:269/402 case
  136.  you have any questions or comments.
  137.  
  138.  AUTOSCAN uses many "outside" programs, without which AUTOSCAN would not
  139.  function. Please show your appreciation and register these fine programs.
  140.  
  141.  WHAT IF
  142.  ~~~~ ~~
  143.  Ok you say, if AUTOSCAN does report than SCAN.EXE found a Virus, what
  144.  do I do????...Easy Either contact McAfee Associates and they can guide
  145.  you through getting rid of the Virus, or you can run SCAN.EXE manually
  146.  with a /D on the command line..SCAN /D, this will delete any file found
  147.  with a virus. The key to Virus protection is that ugly word called
  148.  BACKUP! Always backup any critical files that you may have.
  149.  
  150.  THE REST  
  151.  ~~~ ~~~~
  152.  There is a registration fee of $5.00 US dollars which will entitle you
  153.  to the next 2 versions of AUTOSCAN. See REGIST.DOC for more details.
  154.  
  155.  Thank you to everyone who helped out with the nasty task of debugging
  156.  this thing...THANKS!
  157.  
  158.  This program can and should be distributed freely, no charge should be
  159.  associated with it in anyway. If you run this program you assume all
  160.  liabilities and I shall not be held responsible for any damages that 
  161.  result from its use/missuse...I have strived to make it as error free
  162.  as I can..
  163.  
  164.                          Enjoy it!
  165.                 Nick Tucker....
  166.  
  167.  
  168.                          January 27, 1991
  169.